home *** CD-ROM | disk | FTP | other *** search
/ World of Sound / World of Sound.iso / utils / miditools / obersuite-1.03 / examples < prev    next >
Encoding:
Text File  |  1993-01-23  |  4.4 KB  |  187 lines
  1. EXAMPLES OF USING THE OBERSUITE PROGRAMS
  2. ----------------------------------------
  3. [Note:  When I write "Xpander", I also mean "Matrix-12."]
  4.  
  5. (1) ObGet
  6.  
  7.     Grab Xpander single patch 53 and store it in file "violin":
  8.  
  9.         obget s53 violin
  10.  
  11.     Same as above (case does not matter):
  12.  
  13.         obget S53 violin
  14.  
  15.     Grab Xpander multi patch 99 and store it in file "temp.multi" in the
  16.     RAM disk:
  17.  
  18.         obget m99 ram:temp.multi
  19.  
  20.     Grab Xpander multi patch 61 and store it in file "crimson".
  21.     If the file "crimson" already exists, overwrite it without
  22.     informing the user (this uses the "-a" option):
  23.  
  24.         obget -a m61 crimson
  25.  
  26.     Grab Xpander single patch 03 and store it in file "snake".
  27.     Run in "quiet" mode, with all program output turned off
  28.     except error messages:
  29.  
  30.         obget -q s3 snake
  31.  
  32.     Same as above, but run in "super quiet" mode, turning off all
  33.     output INCLUDING error messages:
  34.  
  35.         obget -Q s3 snake
  36.  
  37.     Grab ALL Xpander single patches and store them in file "everything":
  38.  
  39.         obget s everything
  40.  
  41.     Grab ALL Xpander multi patches and store them in file "multis":
  42.  
  43.         obget m multis
  44.  
  45.     Same as above, but overwrite the file "multis" if it already exists:
  46.  
  47.         obget -a m multis
  48.  
  49.     Same as above, but run in "quiet" mode.  Note that the transfer
  50.     speed is increased by about 25%.
  51.  
  52.         obget -aq m multis
  53.  
  54.     Exactly the same as above (options may be separate or combined):
  55.  
  56.         obget -a -q m multis
  57.  
  58.     Exactly the same as above (options may be in any order):
  59.  
  60.         obget -q -a m multis
  61.  
  62.  
  63. (2) ObPut
  64.  
  65.     Send data from the file "violin" to Xpander patch 98.  (We do
  66.     not have to specify "single" or "multi" patch because the Xpander
  67.     will recognize the data and use it appropriately.)
  68.  
  69.         obput 98 violin
  70.  
  71.     Same as the above, but run in "quiet" mode, turning off all output
  72.     except for error messages:
  73.  
  74.         obput -q 98 violin
  75.  
  76.     Send the data from file "snake" back to its original patch location:
  77.  
  78.         obput snake
  79.  
  80.     Send 100 single patches from file "everything" to the Xpander:
  81.  
  82.         obput everything
  83.  
  84. (3) ObType
  85.  
  86.     Identify the contents of file "violin":
  87.  
  88.         obtype violin
  89.  
  90.     Same as above, but print only the patch name ("short" format):
  91.  
  92.         obtype -s violin
  93.  
  94.     Same as above, but print the output in "long" format:
  95.  
  96.         obtype -l violin
  97.  
  98.     Use ObType to verify that the patch data in file "violin" is
  99.     valid.  If there is a data error, print an error message, but
  100.     otherwise don't print anything:
  101.  
  102.         obtype -q violin
  103.  
  104.     Print the contents of file "everything" (which contains 100
  105.     single patches) in a neat, 1-page format:
  106.  
  107.         obtype everything
  108.  
  109.     Same as above, but print only the patch names, 1 per line:
  110.  
  111.         obtype -s everything
  112.  
  113.     Same as above, but print in "long" format:
  114.  
  115.         obtype -l everything
  116.  
  117.  
  118. (4) ObExtract
  119.  
  120.     In all the following examples, the file "everything" contains
  121. 100 single patches.
  122.  
  123.     Extract the data for patches 2, 3, and 71 from file "everything"
  124.     and store them in files called "everything.s02", "everything.s03",
  125.     and "everything.s71":
  126.  
  127.         obextract -f 2 3 71 everything
  128.  
  129.     Same as above, but the file names will be prefixed with the actual
  130.     names of patches 2, 3, and 71, instead of "everything".  For example,
  131.     if the patch names are TRUMPET, VIOLIN, and KABOOM, then the file
  132.     names will be TRUMPET.s02, VIOLIN.s03, and KABOOM.s71:
  133.  
  134.         obextract -fr 2 3 71 everything
  135.  
  136.     Same as above (options may be combined or separate):
  137.  
  138.         obextract -f -r 2 3 71 everything
  139.  
  140.     Same as above (options may be in any order):
  141.  
  142.         obextract -r -f 2 3 71 everything
  143.  
  144.     Same as above, but any files that already exist will be overwritten
  145.     automatically, without prompting the user:
  146.  
  147.         obextract -r -f -a 2 3 71 everything
  148.  
  149.     Same as above:
  150.  
  151.         obextract -arf 2 3 71 everything
  152.  
  153.     Extract patches 4 through 14 and 81 through 99, storing them in
  154.     individual files.  All of the following examples are EXACTLY
  155.     EQUIVALENT in behavior:
  156.  
  157.         obextract -f 4-14 81-99 everything
  158.         obextract -f 14-4 81-99 everything
  159.         obextract -f 99-81 4 6 5 7-14 everything
  160.         obextract -f 82 9 99 5 10 14 13-4 81 83-97 98 everything
  161.  
  162.     Extract patches 20-30 and send them directly to the Xpander:
  163.  
  164.         obextract -o 20-30 everything
  165.  
  166.     Extract patches 1-10 from file "everything" and store them in
  167.     individual files in the RAM: disk.
  168.  
  169.         1> cd
  170.         df1:patches
  171.         1> cd ram:
  172.         1> obextract -f 1-10 df1:patches/everything
  173.  
  174. (5) Advanced examples
  175.  
  176.     Extract patch number 23 from the file "everything", and send
  177.     it to patch location 91 in the Xpander:
  178.  
  179.         obextract -f 23 everything
  180.         obput 91 everything.s23
  181.  
  182.     Say that your MIDI interface is using device "midi.device",
  183.     unit 2:
  184.  
  185.         setenv OBERHEIM_DEVICE "midi.device:2"
  186.  
  187.